home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 071-080 / amok78 / hotkey / hotkey.dok next >
Text File  |  1993-11-04  |  2KB  |  66 lines
  1.  
  2.                                 HotKey
  3.                               °°°°°°°°°°
  4.  
  5. Dieses Modul vereinfacht die Programmierung von HotKeys mit der
  6. Commodities.library.
  7.  
  8. Es stehen folgenden Prozeduren zur Verfügung:
  9.  
  10. PROCEDURE Init (name,title,descr: ARRAY OF CHAR): SHORTINT;
  11.  
  12.   Es wird das Signal, auf das gewartet werden kann, zurückgeliefert oder 
  13.   -1 bei einem Fehler, dann steht in comErr der CommodityError (c.err*),
  14.   falls es nicht an der Commodities.lib lag (z.B. keine Speicher für den 
  15.   MsgPort), dann steht dort -1.                                          
  16.  
  17.   name: Name des Brokers
  18.   title, descr: Der Text der bei Exchange erscheinen soll
  19.  
  20. PROCEDURE AddKey (descr: ARRAY OF CHAR; ID: INTEGER);
  21.  
  22.   Mit dieser Proz. definiert man ein neuen HotKey.
  23.  
  24.   descr: Beschreibung der HotKeys, z.B. 'alt 1'
  25.   ID   : Zum identifizieren des HotKeys (GetID()).
  26.  
  27. PROCEDURE Activate (ON: BOOLEAN);
  28.  
  29.   Hiermit wird der Broker, und damit alle HotKeys, ein oder ausgeschaltet.
  30.  
  31. PROCEDURE GetID(): INTEGER;
  32.  
  33.   Wenn das Signal von Init() angekommen ist, kann man
  34.   damit feststellen, welcher HotKey gedrückt wurde.
  35.  
  36. PROCEDURE HandleExCh (VAR show, hide, kill: BOOLEAN);
  37.  
  38.  Wenn das Signal 'portSig' angekommen ist, sollte man diese Proz. auf-
  39.  rufen.
  40.  
  41.  show, hide, kill gibt an was per ExChange gewählt wurde.
  42.  Active wird selbständig verwaltet, indem Activate() aufgerufen wird.
  43.  
  44. PROCEDURE DelKeys;
  45.  
  46.  Hiermit kann man vorzeitig alle HotKeys und auch den Broker löschen.
  47.  Diese Proz. wird auch im CLOSE-Teil dieses Moduls aufgerufen.
  48.  
  49.  
  50. Außerdem stehen noch 2 Variablen zur Verfügung:
  51.  
  52.  portSig: Das ist das  Signal des MsgPorts,  das einem geschickt wird, wenn
  53.           das Interface gezeigt, versteckt oder das Programm beendet werden
  54.           soll (durch ExChange).
  55.  comErr : Wenn Init() -1 zurückliefert,  dann steht hier entweder -1, falls
  56.           die MsgPorts nicht erstellt  werden konnten,  oder aber der Grund
  57.           warum der Broker nicht erstellt werden konnte (commodities.Err*).
  58.  
  59. Ein Beispiel, wie man dieses Modul benutzt, befindet sich auch in diesem Archiv.
  60.  
  61.  
  62. Falls ihr irgendwelche Vorschläge, Bugs oder so 'auf dem Herzen' habt, dann
  63. schickt mir 'ne Mail (Addresse steht im HotKey-Modul).
  64.  
  65. Viel Spaß!
  66.